CO 

m 



CO 



Q. 

LU 



(19) 



Europaiscnes Patentamt 
European Patent Office 
Office europeen des brevets 



(12) 

(88) Date of publication A3: 

04.10.2000 Bulletin 2000/40 




(n) EP 0 930 567 A3 

EUROPEAN PATENT APPLICATION 

(51) Int CI. T : G06F 9/445, G06F 1/00, 
G06F 12/14 



(43) /date of publication A2: 

'2 1.07.1999 Bu lletin 1999/29 

(21) Application number 98310592.5 

(22) Date of filing: 22.12.1998 



(84) Designated Contracting States: 




AT BE CH CY DE DK ES Fl FR GB GR IE IT U LU 


(72) Inventor Brewer, Jason M. 


MC NL PT SE 


Dallas, Texas 70206 (US) 


Designated Extension States: 




AL LT LV MK RO SI 


(74) Representative: 




Potter, Julian Mark et al 


(30) Priority. 22.12.1997 US 995603 y 


D. Young & Co., 


21 New Fetter Lane 


(71) Applicant: TEXAS INSTRUMENTS INC.x/ 


London EC4A 1DA (GB) 


Dallas, Texas 75243 (US) 





(54) Method and apparatus for extending security model to native code 



(57) A wireless data platform (10) comprises a 

plurality of processors (12, 16). Channels of 
communication are set up between processors such that 
they may communicate information as tasks are 
performed. A dynamic cross compiler (80) executed on 
one processor compiles code into native processing 
code for another processor. A dynamic cross linker (82) 
links the compiled code for other processor. Native 
code may also be downloaded to the platform through 
use of a JAVA Bean (90) (or other language type) which 
encapsulates the native code. The JAVA Bean can be 
encrypted and digitally signed for security purposes. 



Portable Cod* 




Dynamic Cross 
CompDtr 



80 



unlinked 
target code 



Dynamic Crosi 
jjjter 

Hotl Processor 12 



DSP fl 



CO 

< 



Fig. 3 



EP 0 930 567 A3 
EUROPEAN SEARCH REPORT 



EP 98 31 0592 



DOCUMENTS CONSIDERED TO BE RELEVANT 



Cateoory 


Citation of document with mates non, where appropriate, 
of relevant passages 


Relevant 
to claim 


CLASSIFICATION OP TWE 
APPLICATION (tetjCU) 


X 

X 
A 


EP 0 706 275 A (IBM) 

10 April 1996 (1996-04-10) 

♦ page 2, line 15 - line 17 * 

♦ page 5, line 48 - page 10, line 36 * 

EP 0 778 522 A (SUN MICROSYSTEMS INC) 

11 June 1997 (1997-06-11) 

♦ page 5, line 32 - page 9, line 24 * 

\ 

/ 


1,3-15, 
17-19 

7,8.11, 

12,15, 

17.18 

1,3-6.9. 

10,13, 

14,19 


606F9/445 

G06F1/00 

G06F12/14 


TECHNICAL FIELDS 
SEARCHED (Irt.CU) 


G06F 


The present search report has been drawn up tor all claims 




Pkciotuufi D«» ot cwrpirton ot r» nucti E»«w 

THE HAGUE 11 August 2000 BIJn, K 


CATEGORY OP CITED DOCUMENTS T : theory or principle undertytog ff» Invention 

E : ee/lec patent document but pubf shed on, or 
X : particularly retovant t UKon alone after the Wing data 
Y : particularly retov&nt If combined with anotnor O : documam cited in (ha application 
doevntnt of tha same category L : documant d*od tor othei reasons 

A " technotociciil background -■>--. ...,,.,„ - t-r- - 

O : non-wrilton dbdoaure A : member ol tha same patent lamty. corresponding 
P : rterrnedlate documant Document 



5T 



EP 0 930 567 A3 
ANNEX TO THE EUROPEAN SEARCH REPORT 
ON EUROPEAN PATENT APPLICATION NO. 



EP 98 31 0592 



This annex Bats the patent family members relating to the patent documents cited in the above-mentioned European search report 
The members are as contained in the European Patent Office EDP He on 

The European Patent Offlce Is in no way labia tor these particulars which are merely grven tor the purpo6e of information. 

11-08-2000 



Patent document 
cited in search report 



Publication 



Patent tamiy 
members) 



Publication 
date 



EP 0706275 



10-04-1996 



CA 
US 



2157971 A 
5956408 A 



16-03-1996 
21-09-1999 



EP 0778522 A 11-06-1997 US 6067575 A 23-05-2000 

AU 718051 B 06-04-2000 

AU 7402196 A 12-06-1997 

CA 2191522 A 09-06-1997 

CN 1157959 A 27-08-1997 

JP 10069382 A 10-03-1998 



i 

1 

uj For more details about this annex : see Off icial Journal of the European Patent Office. No. 12/82 



INTERNATIONAL SEARCH REPORT 


In te motion a] application No. 
PCT/US98/0I215 


a /-M ACCiClPATinN fll? SI 1 RlFfT MATTFR 
A* CL*A2>oJ r lv*A 1 iun vr ouimlli m/i i ten 

!PC(6) :H04K 1/00 
US CL :380725. 4, 30 
According lo International Patent Classification (IPC) or to both national classification and IPC 


R FIELDS SEARCHED 


Minimum documentation searched (classification system followed by classification symbols) 
U.S. : 380/25,4,30,23,24 


Documentation searched other than minimum documentation to the extent that such documents arc included in the fields searched 


Electronic data base consulted during the international search (name of data base and, where practicable, search terms used) 


C. DOCUMENTS CONSIDERED TO BE RELEVANT 


Category* 


Citation of document, with indication, where appropriate, of the relevant passages 


Relevant to claim No. 


A, E 


US 5,724,425 A (CHANG, et al.) 03 March 1998, (03/03/98) 


1-22 


A 


US 5,422,953 A (FISCHER) 06 June 1995, (06/06/95) 


1-22 


| | Further documents are listed in the continuation of Box C. 


[~"| See patent family annex. 




■ Special categories of cited document*: 

a A" document defining the general state of the art which is not considered 
to be of pedicular relevance 

•E* earlier document published on or after the international filing date 

"L* document which may throw doubts on priority clatra(a) or which is 
cited to establish the publication dale of another citation or other 
special reason (as specified) 

*0* document referring to an oral disclosure, use. exhibition or other 
means 

*P" document published prior to the international filing date but later than 
the priority date claimed 


*T* later document published after the tntemauonal filing date or priority 
data and not in conflict with the application but cited to understand 
the principle or theory underlying the invention 

*X* document of particular relevance; the claimed invention cannot be 
considered novel or cannot be considered to involve an inventive step 
when the document is taken alone 

*Y* document of particular relevance; the claimed invention cannot be 
considered to involve an inventive step when the document is 
combined with on* or more other such documents, such combination 
being obvious to a person skilled m the art 

"A" document member of the same patent family 


Date of the actual completion of the international search 
05 JUNE 1998 


Date of mailing of the international search report 

10 JUL 1998 


Nome and mailing address of the ISA/US 
Commissioner of Patents and Trademarks 
Box PCT 

Washington, D.C. 20231 
Facsimile No. (703) 3050230 


Authorized o*"'^^^ 
^feAVlDCAtN V 
Telephone No. (703) 305- 1 836 



Description 



EP 0 930 567 A2 



CROSS-REFERENCE TO RELATED APPLICATIONS 

5 [0001] This application is related to U.S. Ser No. 08/995.606, entitled "Mobile Information Services Platform" (Atty 
Docket No. 26421) to McMahon et al, US. Ser. No. 08/995,600 entitled "Mobile Communication System with Cross 
Compiler and Cross Linker" (Atty Docket No. 26453) to Woolsey et al. and U.S. Ser. No 08/995.597, entitled "Method 
and Apparatus for Providing Downloadable Functionality to an Embedded Coprocessor" (Atty Docket No. 26440) to 
Brewer, all filed on even date herewith and incorporated by reference herein. Copies of these documents have been 

10 placed on the public part of the file and are available to public inspection in accordance with Art 128(4) EPC. 

BACKGROUND OF THE INVENTION 
1. TECHNICAL FIELD 

15 

[0002] This invention relates in general to mobile electronic devices and, more particularly, but not exclusively, to a 
hardware and software platform for mobile electronic devices. 

Z DESCRIPTION OF THE RELATED ART 

20 

[0003] Handheld portable devices are gaining popularity as the power and. hence, functionality of the devices 
increases. Personal Digital Assistants (PDAs) are currently in widespread use and Smartphones, which combine the 
some of the capabilities of a cellular phone and a PDA, are expected to have a significant impact on communications 
in the near future. 

25 [0004] Some devices currently incorporate one or more DSPs (digital signal processor) or other coprocessors for pro- 
viding certain discrete features, such as voice recognition, and a general purpose processor for the other data process- 
ing functions. The code for the DSP and the code for the general purpose processor is generally stored in ROMs or 
other nonvolatile memories, which are not easily modified. Thus, as improvements and new features become available, 
it is often not possible to upgrade the capabilities of the device. In particular, it is not possible to maximize the use of the 

30 DSPs or other coprocessor which may be present in the device. 

[0005] Therefore, a need exists for a data processing architecture which can be upgraded and optimizes use of mul- 
tiple processors and coprocessors. 

BRIEF SUMMARY OF THE INVENTION 

35 

[0006] In a first embodiment of the present invention, a file of native code within an software program including source 
code is stored in an external device, which encrypts both the source code and the native code in the software program. 
The encrypted software program is downloaded to the electronic device, where the software program is decrypted and 
the native code is retrieved. The native code is installed on a target processor where it is executed. 
40 [0007] In a second embodiment of the present invention, a file of native code within an software program including 
source code is stored in an external device, which applies a digital signature to the software program. The software pro- 
gram is downloaded to the electronic device, where the signature is verified. Responsive to the verification, the native 
code is retrieved and installed on a target processor where it is executed. 

[0008] Embodiments of the present invention provide significant advantages. Where the native code is encrypted dur- 
45 ing transmission along with the code of the software program, unauthorized modification of the code is prevented. 
Where a digital signature is applied to the software program, the authenticity of the code can be verified. Because the 
native code is secure and comes from a trusted source, the attributes of the native code can also be trusted as accu- 
rate. Where the software program is a JAVA Bean, the built in security processes of JAVA can be used to encrypt and 
sign the Bean and, hence, the native code. 

50 

BRIEF DESCRIPTION OF THE SEVERAL VIEWS OF THE DRAWINGS 

[0009] Embodiments of the present invention, will now be described, by way of example only, and taken in conjunction 
with the accompanying drawings, in which: 

55 

Figure 1 illustrates a block diagram of a platform architecture particularly suited for general wireless data process- 
ing; 
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Figure 2 illustrates a functional block diagram of the platform of Figure 1 ; 

Figure 3 illustrates a functional Nock diagram of dynamic cross compiling and dynamic cross linking functions; 

5 Figure 4 illustrate an embodiment of native code for execution on a processor being encapsulated in a JAVA Bean 
wrapper for downloading to a device; 

Figure 5 illustrates the operation of transferring the encapsulated native code to a processor on a device from a 
JAVA Bean located on a remote server; and 

10 

Figure 6 illustrates a flow diagram describing security features associated with the operation of Figure 5. 
DETAILED DESCRIPTION OF THE INVENTION 

75 [001 0] In the following description like numerals are used for like elements of the various drawings. 

[0011] Figure 1 illustrates a preferred embodiment of a general wireless data platform architecture, which could be 
used for example, in the implementation of a Smartphone or PDA. The wireless data platform 10 includes a general pur- 
pose (Host) processor 12 coupled to bus structure 14, including data bus 14a, address bus 14b and control bus 14c. 
One or more DSPs (or other coprocessors) 16, including the core processor 16a and the peripheral interface 16b, are 

20 coupled to bus 14 and to memory and traffic controller 18. which includes a DSP cache memory 18a. a CPU cache 18b. 
and a MMU (memory management unit) 18c. Ahardware accelerator circuit 20 (for accelerating a portable language 
such as JAVA) and a video and LCD controller 22 are also coupled to the memory and traffic controller 18. The output 
of the video and LCD controller is coupled to a LCD or video display 24. 

[0012] Memory & traffic controller 18 is coupled to bus 14 and to the main memory 26. shown as an SDRAM (syn- 
25 chronous dynamic random access memory). Bus 14 is also connected to I/O controller 28. interface 30, and RAM/ROM 

32. A plurality of devices could be coupled to the wireless data platform 1 0, such as smartcard 34. keyboard 36. mouse 

38, or one or more serial ports 40, such as a USB (universal serial bus) port or an RS232 serial port. Interface 30 can 

couple to a flash memory card 42 and/or a DRAM card 44. The peripheral interface 16b can couple the DSP 16 to a 

DAC (digital to analog converter) 46. a network interface 48 or to other devices. 
30 [0013] The wireless data platform 10 of Figure 1 utilizes both a general purpose processor 12 and a DSP 16. Unlike 

current devices in which the DSP 1 6 is dedicated to specific fixed functions, the DSP 1 6 of Figure 1 can be used for any 

number of functions. This allows the user to derive the full benefit of the DSP 16. 

[0014] One main area in which the DSP 16 can be used is in connection with the man-machine interface (MM!). 
Importantly, functions like speech recognition, image and video compression and decompression, data encryption, text* 
35 to-speech conversion, and so on, can be performed much more efficiently using the DSP 16. The present architecture 
allows new functions and enhancements to be easily added to wireless data platform 10. 

[001 5] It should be noted that the wireless data platform 1 0 is a general block diagram and many modifications could 
be made. For example, Figure 1 illustrates separate DSP and processor caches 18a and 18b. As would be known to 
one skilled in the art. a unified cache could also be used. Further, the hardware acceleration circuit 20 is an optional 
AO item. Such devices speed the execution of languages such as JAVA; however, the circuit is not necessary for operation 
of the device. Further, although the illustrated embodiment shows a single DSP. multiple DSPs (or other coprocessors) 
could be coupled to the buses. 

[001 6] Figure 2 illustrates a functional software architecture for the wireless data platform 1 0. This block diagram pre- 
sumes the use of JAVA; it should be noted that languages other than JAVA could be used as well. Functionally, the soft- 

45 ware is divided into two groups. Host processor software and DSP software. The Host software includes one or more 
applets 40. The DSP API class 42 is a JAVA API package for JAVA applications or applets to access the functionality 
of the DSP API 50 and Host DSP Interface Layer 52. A JAVA virtual machine (VM) 44 interprets the applets. The JAVA 
native interface 46 is the method which the JAVA VM executes host processor or platform specific code. Native tasks 
48 are non-JAVA programs which can be executed by the Host processor 12 without using the JAVA native interface. 

so The DSP API 50. described in greater detail hereinbelow, is an API (application program interface) used the Host 12 to 
call to make use of the capabilities of the DSP 16. The Host-DSP Interface Layer 52 provides an API for the Host 12 
and DSP 16 to communicate with each other, with other tasks, or other hardware using channels via the Host-DSP 
Communication Protocol. The DSP device driver 54 is the Host based device driver for the Host RTOS 56 (real time 
operating system) to communicate with the DSP 16. The Host RTOS 56 is an operating system, such as NUCLEUS 

55 PLUS by Accelerated Technology Incorporated. Alternatively a non-real time operating system, such as WINDOWS CE 
by Microsoft Corporation, could be used. The DSP Library 58 contains programs stored for execution on the DSP 16. 
[0017] On the DSP side, one or more tasks 60 can be stored in memory for execution by the DSP16. As described 
below, the tasks can be moved in and out of the memory as desired, such that the functionality of the DSP is dynamic. 
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rather than static. The Host-DSP interface layer 62 on the DSP side performs the same function as the Host-DSP Inter- 
face layer 52 on the Host side, namely it allows the Host 12 and DSP 16 to communicate. The DSP RTOS 64 is the 
operating system for the DSP processor. The Host Device driver 66 is a DSP based device driver for the DSP RTOS 64 
to communicate with the Host 12. The Host-DSP Interface 70 couples the DSP 16 and Host 12. 
5 [001 8] In operation, the software architecture shown in Figure 2 uses the DSP 1 6 as a variable function device, rather 
than a f ixed function device as in the prior art Accordingly, the DSP functions can be downloaded to the mobile device 
incorporating the architecture of Figure 2 to allow the DSP 16 to perform various signal processing functions fa the 
Host 12. 

10 DSP-API 

[0019] The DSP-API provides a device independent interface from the Host 12 to the DSP 16. The functions provide 
the Host 1 2 with the ability to load and schedule tasks on the DSP 1 6 and to control and communicate with those tasks. 
The API functions include calls to: determine the DSP's available resources, create and control Host 12 and DSP tasks, 
15 create and control data channels between Host 12 and DSP tasks, and communicate with tasks. These functions are 
described below. Each function returns a BOOLean result, which will be SUCCESS for a successful operation, or FAIL- 
URE. If the result is FAILURE, the errcode should be checked to determine which error occurred. 

DSP_Get_MlPS 

20 

BOOL DSP_GeLMIPS(T_DevicelD DevID, U32 'mips, U16 'errcode); 

[0020] This function returns the current MIPS available on the DSP. This consists of the MIPS capability of the DSP 
16 minus a base MIPS value (the MIPS value with no additional dynamic tasks, i.e. the kernel plus API code plus driv- 
es ers), minus the sum of the MIPS ratings for all loaded dynamic tasks. The errcode parameter will contain the following 
possible results: 

DSP_SUCCESS 
DSP_DEVID_NOT_FOUND 
30 DSPJ)EVID_NOT_RESPONDING 

DSP_Get_Memory_Available 

BOOL DSPjGeLMemory_Availabie(TJDevicelD DevID, T_Size 'progmem, TJSize 'datamem, U16 'errcode); 

35 

[0021 ] This function will query the DSP 1 6 specified by DevID for the amounts of available memory for both program 
memory and data memory. The resultant values are returned in the progmem and datamem parameters. The sizes are 
specified in T_DSP_Words. The errcode parameter will contain the following possible results: 

40 DSP_SUCCESS 

DSPJ}EVIDJ^OT_FOUND 
DSP_DEVID_NOT_RESPOND!NG 

DSP_Alloc_Mem 

45 

BOOL DSP_Alloc_Mem(T_DevicelD DevID, U16mempage, T_Sizesize, T^DSPJWord "memptr, U16 'errcode); 

[0022] This function will allocate a block of memory on a DSP 1 6. The DevID specifies which device on which to allo- 
cate the memory. The mempage is 0 for program space, and 1 for data space. The size parameter specifies the mem- 
so ory block size in T_DSP_Words. The returned memptr will be a pointer to the memory block on the DSP 16, or NULL 
on failure. The errcode parameter will contain the following possible results: 

DSP_SUCCESS 
DSPJ)EVID_NOT_FOUND 
55 DSPJDEVID_NOT_RESPONDING 
DSPJNVALIDJvlEMPAGE 

dsp!not_enough_memory 
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DSP_Free_Mem 

BOOL DSP_Free_Mem(T_DeviceID DevID, U16 mempage, T_ DSP^Word 'memptr, U16 'encode); 

s [0023] This function will free a block of memory on a DSP that was allocated with the DSP_Alloc_Mem function. The 
DevID specifies on which device the memory resides. The mempage is 0 for program space, and 1 for data space. The 
memptr parameter is the pointer to the memory block The encode parameter will contain the following possible results: 

DSP_SUCCESS 
10 DSPJ3EVID_NOT_FOUND 

DSPJDEVIDJ^OT_RESPONDING 

DSPJNVALIDMEMPAGE 

DSP_MEMBLOCK_NOT_FOUND 

is DSP_Get_Code_lnf6 

BOOL DSP_GeLCodeJnfo(char 'Name, TjCodeHdr 'codehdr, U16 'encode); 

[0024] This function will access the DSP Library table and return the code header for the DSP function code specified 
20 by the Name parameter. On return, the location pointed to by the codehdr parameter will contain the code header infor- 
mation. The encode parameter will contain the following possible results: 

DSP_SUCCESS 

DSP_N AMED_FU NC_NOT_FOU N D 

25 

DSP_Link_Code 

BOOL DSP_Link_Code(T_DevicetD DevID, TjCodeHdr 'codehdr, TJTaskCreate 'tcs, U16 'encode); 

30 [0025] This function will link DSP function code so that it wilt run at a specified address on the DSP specified by 
DevID. The codehdr parameter points to the code header for the function. The dynamic cross linker will link the code 
based on information in the code header, and in the code (COFF file). The dynamic cross linker will allocate the memory 
as needed, and link and load the code to the DSP 16. The tcs parameter is a pointer to the task creation structure 
needed in the DSP_Create_Task function. DSP_Link_Code will fill in the code entry points, priority, and quantum fields 

35 of the structure in preparation for creating a task. The encode parameter will contain the following possible results: 

DSP_SUCCESS 
DSPJDEVID_NOT_FOUND 
DSP_DEVID_NOT_RESPONDING 
40 DSP_NOT_E NOUGH_P ROG_M EMO RY 
D SP_NOT_E NOUGH_DATA_MEMORY 
DSP_COULDjS)OTJ_OAD_CODE 

DSP_Put_BLOB 

45 

BOOL DSP_PuLBLOB(T_DevicelD DevID, T_HostPtr srcaddr, T_DSP_Ptr destaddr, U1 6 mempage, T_Sizesize, U16 
'encode); 

[0026] This function will copy a specified Binary Large Object (BLOB) to the DSP 16. The DevID specifies on which 
so DSP 16 to copy the object The srcaddr parameter is a pointer to the object in Host memory. The destaddr is a pointer 
to the location to which to copy the object on the DSP 16. The mempage is 0 for program space, and 1 for data space. 
The size parameter specifies the size of the object in T_DSP_Words. The encode parameter will contain the following 
possible results: 

55 DSP_SUCCESS 

DSP_DEVID_NOT_FOUND 

DSPJDEVID_NOT_RESPONDING 

DSPJNVAUDJ/IEMPAGE 



5 



EP0 930 567 A2 

DSP_Create_Task 

BOOL DSP_Create_Task(T_DevicelD DevID, T_TaskCreate 'tcs, T_Task!D 'TaskID, U16 'errcode); 

5 [0027] DSP_Create_Task requests the DSP 1 6 to create a task given the task parameters and the code locations in 
the DSP's program space. The Task Creation Structure is show in Table 1 : 



Table 1 



10 


Task Creation Structure. 


Data Type 


Reid Name 


Description 




T_DSP_Name 


Name 


User def ined name for the task. 


15 


U32 


MIPS 


MIPS used by the task. 


T_ChanlD 


Chan In 


The channel ID used for task input 




T_ChanlD 


ChanOut 


The channel ID used for task output 




T_StrmlD 


Strmln 


The stream ID used for task input. 




T_StrmID 


StrmOut 


The stream ID used for task output. 




U16 


Priority 


The task's priority. 




U32 


Quantum 


The task's timeslice in system ticks. 


25 


T_Size 


StackReq 


The amount of stack required. 




T_DSP_Ptr 


MsgHandler 


Pointer to code to handle messages to the task. 




T_HOST_Ptr 


CallBack 


Pointer to Host code to handle messages from the task. 




T_DSP_Ptr 


Create 


Pointer to code to execute when task is created. 


30 


T_DSP_Ptr 


Start 


Pointer to code to execute when task is started. 




T_DSP_Ptr 


Suspend 


Pointer to code to execute when task is suspended. 




T_DSP_Ptr 


Resume 


Pointer to code to execute when task is resumed. 


35 ; 


T_DSP_Ptr 


Stop 


Pointer to code to execute when task is stopped. 



[0028] Once the task is created, the Create entry point will be called, giving the task the opportunity to do any neces- 
sary preliminary initialization. The Create, Suspend. Resume, and Stop entry points can be NULL The resultant TaskID 
40 contains both the device ID (DevID), and the DSP's task ID. H the TaskID is NULL, the create failed. The encode param- 
eter will contain the following possible results: 

DSP_SUCCESS 
DSP_DEVID_NOT_FOUND 
45 DSPJDEVIDJ^OT_RESPONDING 
DSPJNVALID_PRIORI7Y 
DSP_CHANNEL_NOT_FOUND 
DSP_ALLOCATION_ERROR 

so DSP_Start_Task 

BOOL DSP_Start_Task(T_TasktD TaskID, U16 'encode); 

[0029] This function will start a DSP task specified by TaskID Execution will begin at the task's Start entry point The 
55 encode parameter will contain the following possible results: 

DSP.SUCCESS 
DSP_DEVID_NOT_FOUND 
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DSPJ)EVID_NOT_RESPONDING 
DSPJTASK_NOT_FOUND 

DSP_Suspend_Task 

5 

BOOL DSP_Suspend_Task(T_TasklD TasklD, U16 'encode); 

[0030] This function will suspend a DSP task specified by TasklD. Prior to being suspended, the task's Suspend entry 
point will be called to give the task a chance to perform any necessary housekeeping. The encode parameter will con* 
to tain the following possible results: 

DSP_SUCCESS 
DSPJDEVIDJ^OTJOUND 
DSP_DEVIDJ^OT_RESPONDING 
75 DSP_TASK_NOT_FOUND 

DSP_Resume_Task 

BOOL DSP_Resume_Taskfr_TasklD TasklD, U16 'encode); 

20 

[0031 ] This function will resume a DSP task that was suspended by DSP_Suspend_Task. Prior to being resumed, the 
task's Resume entry point will be called to give the task a chance to perform any necessary housekeeping. The encode 
parameter will contain the following possible results: 

25 DSP_SUCCESS 

DSP_DEVID_NOT_FOUND 
DSP_DEVIDJslOT_RESPONDING 
DSPJTASK_NOT_FOUND 
DSP_TASK_NOT_SUSPENDED 

30 

DSP_Delete_Task 

BOOL DSP_DeleteJTask(TJTasklD TasklD, U16 'encode); 

35 [0032] This function will delete a DSP task specified by TasklD Prior to the deletion, the task's Stop entry point will 
be called to give the task a chance to perform any necessary cleanup. This should include freeing any memory that was 
allocated by the task, and returning any resources the task acquired. The encode parameter will contain the following 
possible results: 

40 DSP_SUCCESS 

DSP_DEVID_NOT_FOUND 

DSP_DEVIDJJOT_RESPONDING 

DSPJTASK_NOT_FOUND 

45 DSP_Change_Task_PrIortty 

BOOL DSPjChange_Task_Priority(TJTasklD TasklD, U16newpriority, U16 'oldpriority, U16 'encode); 

[0033] This function will change the priority of a DSP task specified by TasklD The priority will be changed to 
so newpriority. The possible values of newpriority are RTOS dependent Upon return, the oldpriority parameter will be set 
to the previous priority of the task. The encode parameter will contain the following possible results: 

DSP_SUCCESS 
DSPJ3EVIDJ^OT_FOUND 
55 DSP_DEVID_NOT_RESPONDING 
DSPJTASK_NOT_FOUND 
DSPJNVAUD^PRIORITY 
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DSP_Get_Task_Status 

BOOL DSP_GeLTask_Statu$(T_TasklD TaskID, U16 'status, U16 'priority, TjOhanID 'input T^ChanlD 'Output, U16 
'encode); 

5 

[0034] This function returns the status for a DSP task specified by TaskID. The status will be one of the following val- 
ues: 

DSP_TASK_RUNNING 
io DSPJTASKSUSPENDED 
DSPJTASK_WAITFOR_SEM 
DSP_TASK_WAnTOR_QUEUE 
DSPJTASKJ/VAITFOR_MSG 

is [0035] The priority parameter will contain the task's priority, and the Input and Ouput parameters will contain the 
task's input and output channel IDs. respectively. The errcode parameter will contain the following possible results: 

DSP_SUCCESS 
DSPJDEVID_NOT_FOUND 
20 DSPJDEVID_NOT_RESPONDING 
DSPJTASK_NOT_FOUND 

DS P_Get_l D_From_Name 

25 BOOL DSP_GeUD-From_Name(TJ)evicelD DevID, T__DSP_Name Name, TJDSPJD 'ID, U16 'encode); 

[0036] This function returns the ID for a named object on the DSP 16. The named object may be a channel, a task, 
a memory block, or any other supported named DSP object The errcode parameter will contain the following possible 
results: 



30 



35 



40 



45 



50 



55 



DSP_SUCCESS 
DSP_DEVID_NOT_FOUND 
DSP_DEVIDJ^OT_RESPONDING 
DSP_NAME_NOT_FOUND 

DSP_Dbg_Read_Mem 

BOOL DSP_Dbg_Read_Mem(DEVICE_ID DevID, U8 mempage, DSP_PTR addr, U32 count, DSP^WORD *buf, U16 
'errcode); 

[0037] This function requests a block of memory. The mempage specifies program memory (0) or data memory (1). 
The addr parameter specifies the memory starting address, and the count indicates how many T_DSP_Words to read. 
The buf parameter is a pointer to a caller provided buffer to which the memory should be copied. The errcode param- 
eter will contain the following possible results: 

DSP_SUCCESS 
DSPJ)EVID_NOT_FOUND 
DSP_DEVID_NOT_RESPONDING 
DSPJNVALIDJvlEMPAGE 

DSP_Dbg_WrrteJ/lem 

BOOL DSP_Dbg_Write_Mem(T_DevicetD DevID, U1 6 mempage, T_DSP_Ptr addr, TjDount count, T_DSP_Word 
'buf, U16 'encode); 

[0038] This function writes a block of memory. The mempage specifies program memory (0) or data memory (1 ). The 
addr parameter specifies the memory starting address, and the count indicates how many T_DSP_Words to write. The 
buf parameter is a pointer the buffer containing the memory to write. The errcode parameter will contain the following 
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possible results: 

DSP_SUCCESS 
DSP_DEVID_NOT_FOUND 
5 DSP_DEVID_NOT_RESPONDING 
DSPJNVAUD_MEMPAGE 

DSP_Dbg_Read_Reg 

to BOOL DSP_Dbg_Read_Reg(T_DevicelD DevID, U16 RegtD, T_DSP_Word 'regvalue, U16 'encode); 

[0039] This function reads a DSP register and returns the value in regvafue. The RegID parameter specifies which 
register to return. H the RegID is -1, then all of the register values are returned. The regvafue parameter, which is a 
pointer to a caller provided buffer, should point to sufficient storage to hold all of the values. The register IDs are DSP 
is specific and will depend on a particular implementation. The encode parameter will contain the following possible 
results: 

DSP_SUCCESS 
DSP_DEVID_NOT_FOUND 
20 DSP_DEVID_NOT_RESPONDING 
DSPJNVAUD_REGISTER 

DSP_Dbg_Write_Reg 

25 BOOL DSP_Dbg_Write_Reg(T_DevicelD DevID, U16 RegID, T_DSP_Word regvalue, U16 'encode); 

[0040] This function writes a DSP register. The RegID parameter specifies which register to modify, regvalue contains 
the new value to write. The register IDs are DSP specific and will depend on a particular implementation. The encode 
parameter will contain the following possible results: 

30 

DSP_SUCCESS 
DSP_DEVIDJ40T_FOUND 
DSP_DEVID_NOT_RESPONDING 
DSPJNVAUD_REGISTER 

35 

DSP_Dbg_Set_Break 

BOOL DSP_Dbg__SeLBreakfT_DevicelD DevID, DSP_Ptraddr, U16 'encode); 

40 [0041] This function sets a break point at the given code address (addt). The encode parameter will contain the fol- 
lowing possible results: 

DSP_SUCCESS 
DSPJ)EVIDJ^OT_FOUND 
45 DSPJ)EVIDJtt)T_RESPONDING 

DSP_Dbg_Clr_Break 

BOOL DSP_Dbg_Clr_Break(T_DevicelD DevID, T_DSP_Ptr addr, U16 *errcode); 

so 

[0042] This function clears a break point that was previously set by DSP_Dbg_Set_Break at the given code address 
(addr). The encode parameter will contain the following possible results: 

DSP_SUCCESS 
55 DSP_DEVID_NOT_FOUND 

DSPJ)EVID_NOT_RESPONDING 
DSP_BP_DID_NOT_EXIST 



9 



EP 0 930 567 A2 



DSP DEVICE DRIVER 

[0043] The DSP Device Driver 54 handles communications from the Host 12 to the DSP 16. The driver functions will 
take the communication requests as specified in the Host-DSP Communications Protocol and handle the transmission 
5 of the information via the available hardware interface The device driver is RTOS dependent and communications hard- 
ware dependent. 

DSPUBRARY 

io [0044] The DSP Library 58 contains the blocks of code that can be downloaded to the DSP 16 for execution. Each 
block of code will be previously unlinked, or relocatably linked as a library, so that the dynamic cross linker can resolve 
all address references. Each code block will also include information about the block's requirements for DSP MIPS (mil- 
lions of instructions per second), priority, time slice quantum, and memory. The format for the code block header is 
shown in Table 2. The program memory and data memory sizes are approximations to give the Host 12 a quick check 

is on whether the DSP can support the task's memory requirements. If there appears to be sufficient space, the dynamic 
cross linker can then attempt to link and load the code. It should be noted that the dynamic cross linker could still fail, 
due to page alignment and contiguity requirements. In the preferred embodiment, the code is in a version 2 COFF file 
format 



20 

Table 2 





Cc 1e Block Header. 


Data Type 


Field Name 


Description 


25 


U16 


Processor 


The target processor type. ! 




T_DSP_Name 


Name 


Task's name. 




U32 


MIPS 


Worst case MIPS required by the task. 


30 


TSize 


ProgSize 


Total program memory size needed. 


T_Size 


DataSize 


Total data memory size needed. 




T_Size 


InFrameSize 


Size of a frame in the task's input channel. 




T_Size 


OutFrameSize 


Size of a frame in the task's output channel. 


35 


T_Size 


InStrmSize 


Size of the task's input stream FIFO. 




T_Size 


OutStrmSize 


Size of the task's output stream FIFO. 




U16 


Priority 


Task's priority. 


40 


U32 


Quantum 


Task's time slice quantum (number of system ticks). 




T_Size 


StackReq 


Stack required. 




T_Size 


CoffSize 


Total size of the COFF file. 




T_DSP_Ptr 


MsgHandler 


Offset to a message handler entry point for the task. 


45 


T_DSPJ>tr 


Create 


Offset to a create entry point that is called when the task is created. 




T_DSP_Ptr 


Start 


Offset to the start of the task's code. 




T_DSP_Ptr 


Suspend 


Offset to a suspend entry point that is called prior to the task being suspended. 


50 


T_DSP_Ptr 


Resume 


Offset to a resume entry point that is called prior to the task being resumed. 




T_DSP_Ptr 


Stop 


Offset to a stop entry point that is called prior to the task being deleted. 




T_Host_Ptr 


CoffPtr 


Pointer to the location of the COFF data in the DSP Library. 



55 CONVERSION OF PORTABLE CODE INTO LINKED TARGET CODE 



[0045] A procedure for converting portable (processor independent) code, such as JAVA code, into linked target code 
is shown in Figure 3. The procedure uses two functions, a dynamic cross compiler 80 and a dynamic cross linker 82. 
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Each function is implemented on the host processor 1 2. The dynamic cross linker is part of the DSP- API in the preferred 
embodiment. The cross compiler may also be part of the DSP-API. 

[0046] The dynamic cross compiler 80 converts portable code into unlinked, executable target processor code. The 
dynamic cross linker 82 converts the unlinked, executable target processor code into linked, executable target proces- 

5 sor code. To do so. it must resolve addresses within a block of code, prior to loading on the DSP 16. The dynamic cross 
linker 82 links the code segments and data segments of the function, allocates the memory on the DSP 16. and loads 
the code and constant data to the DSP 16. The functions are referred to as "cross" compiling and "cross" linking, 
because the functions (compiling and linking) occur on a different processor (i.e.. the host processor 12) from the target 
processor which executes the code (i.e.. the DSP 16). 

10 [0047] The dynamic cross compiler 80 accepts previously unlinked code loaded on demand by a user or a user agent 
(such as a browser). The code is processed to either (1) identify lagged" sections of the code or (2) analyze untagged 
code segments for suitability of execution on the DSP 16. A tagged section of source code could delineate source tar- 
getable to a DSP by predetermined markers such as "(start DSP code)" and <end DSP code) " embedded in the source 
code. If a tagged section is identified either directly or through analysis, a decision is made to either cross compile or 

15 not based on the current processing state of the DSP 16. If a decision is made to compile, the section of code proc- 
essed by compiling software that outputs unlinked, executable target processor code, using well known compiling meth- 
ods. A decision not to compile could be made if for example, the DSP has insufficient available processing capacity 
(generally stated as available MIPS - million of instructions per second) or insufficient available memory, due to other 
tasks being executed by the DSP 16. The compiled code can be passed to the dynamic cross linker 82 for immediate 

20 use in the DSP 16, or could be saved in the DSP library 58. 

[0048] The dynamic cross linker 82 accepts previously unlinked code, which is either (1) statically stored in connection 
with the host processor 12 or (2) dynamically downloaded to the host processor 12 over a network connection (includ- 
ing global networks such as the Internet) or (3) dynamically generated by the dynamic cross compiler 80. The dynamic 
cross linker 82 links the input code for a memory starting address of the DSP 16 determined at runtime. The memory 

25 starting address can be determined from a memory map or memory table stored on and managed by either the host 
processor 12 or DSP 16. The dynamic cross linker 82 convert referenced memory locations in the code to actual mem- 
ory locations in the DSP. These memory locations could include, for example, branch addresses in the code or refer- 
ences to locations of data in the code. 

[0049] In the preferred embodiment, the portable code is in a COFF (common object file format) which contains all 
30 information about the code, including whether it is linked or unlinked. If it is unlinked, symbol tables define the address 
which must be changed for linking the code. 

[0050] The conversion process described above has several significant advantages over the prior art First, the 
dynamic cross compiler 80 allows run-time decisions to be made about where to execute the downloaded portable 
code. For example, in a system with multiple target processors (such as two DSPs 16), the dynamic cross compiler 80 

35 could compile the portable code to any one of the target processors based on available resources or capabilities. The 
dynamic cross linker 82 provides for linking code to run on a target processor which does not support relocatable code. 
Since the code is linked at run-time, memory locations in the DSP 16 (or other target processor) do not need to be 
reserved, allowing optimum efficiency of use of all computing resources in the device. Because the compiling is accom- 
plished with knowledge of the architecture of the platform 10, the compiling can take advantage of processor and plat- 

40 form specific features, such as intelligent cache architectures in one or both processors. 

[0051] Thus, the DSP 1 6 can have various functions which are changed dynamically to fully use its processing capa- 
bilities. For example, the user may wish to load a user interface including voice recognition. At that time, the host proc- 
essor could download software and dynamically cross compile and cross link the voice recognition software for 
execution in the DSP 16. Alternatively, previously compiled software in the DSP library 58 could be dynamically cross 

45 linked, based on the current status of the DSP 16, for execution. 

HOST DEVICE DRIVER 

[0052] The Host Device Driver handles communications from the DSP 16 to the Host 12. The driver functions takes 
so the communication requests as specified in the Host-DSP Communications Protocol and handles transmission of the 
information via the available hardware interface. The device driver is RTOS dependent and communications hardware 
dependent. 

HOST-DSP COMMUNICATIONS PROTOCOL (HOST-DSP INTERFACE LAYER) 

55 

[0053] The Host-DSP Communications Protocol governs the communications of commands and data between the 
Host 12 and the DSP 16. The communications consist of several paths: messages, data channels, and streams. Mes- 
sages are used to send initialization parameters and commands to the tasks. Data channels carry large amounts of 
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data between tasks and between the DSP 16 and Host 12. in the form of data frames. Streams are used to pass 
streamed data between tasks and between the DSP 16 and Host 12. 

Messages 

5 

[0054] Each task has an entry point to a message handler, which handles messages. The messages are user defined 
and will include initialization parameters for the task's function, and commands for controlling the task The tasks send 
messages to the Host 12 via the callback specified when the task is created. The prototype for the task's message han- 
dler and the prototype for the Host's callback are shown here: 

TO 

void TaskMsgHandler(T_ReplyRef replyref, T_MsglD MsgID, T^Count count, T_DSP_Word *buf); 
void HostCaJIBack(T_ReplyRef replyref, T_MsglD MsgID, T_Count count T_DSP_Word *buf); 

[0055] The replyref parameter refers to an implementation dependent reference value, which is used to route the reply 
75 back to the sender. For every Sendjvlessage call, the recipient must call Reply_Message using the replyref parameter. 
The actual messages may appear as follows: 



Sent message: 


MsgPktFlag 


taskid 


replyref 


msgid 


count 


buf[ ] 


Reply message: 


MsgPktFlag 


-1 


replyref 


msgid 


count 


buf[ ] 



The multiword data is sent least-significant word first 
25 [0056] A TasklD of 0 in the Sendjvlessage function indicates a system level message. The system level messages 
are used to implement the DSP-API functions 
[0057] Following are the Message functions: 

Sendjvlessage 

30 

BOOL Send_Message(TJTasklD TasklD, T^MsglD MsgID, T_Count count, T_DSP_Word 'msgbuf, T_DSP_Word 
'replybuf, T_Size replybufsize, TJDount replycount, U16 *errcode); 

[0058] This function will send a user defined message to a task specified by TasklD. The MsgID defines the message, 
35 and the msgbuf contains the actual message data. The message size is count TJDSPJAfords. The reply to the mes- 
sage will be contained in the replybuf parameter, which points to a buffer of size replybufsize, provided by the caller. It 
should be of sufficient size to handle the reply for the particular message. The encode parameter will contain the fol- 
lowing possible results: 

40 DSP_SUCCESS 

DSP_DEVID_NOT_FOUND 

DSPJ)EVIDjgOTRESPONDING 

DSP.TASK.NOT.FOUND 

45 Replyjrtessage 

BOOL Reply_Mes$age(T_ReplyRef replyref, T_Count count, T__DSP__Word *buf, U16 'encode); 

[0059] This function is used to reply to messages. The replyref parameter is a reference used to route the reply back 
so to the sender of the original message, and is implementation specific. The reply is contained in the but parameter and 
its size is count T_DSP_Words. The encode parameter will contain the following possible results: 

DSP_SUCCESS 
DSPJDEVID_NOT_FOUND 
55 DSPJDEVIDJ^OT_RESPONDING 
DSP_BAD_REPLY_REF 
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Channels 

[0060] The concept of channels is used to transmit frame-based data from one processor to another, or between taste 
on the same processor. When created, a channel allocates a specified number and size of frames to contain the data. 
5 Initially, the channel will contain a list of empty frames. Tasks that produce data win request empty frames in which to 
put the data, then once filled, the frame is returned to the channel. Tasks that consume data will request full frames from 
the channel, and once emptied, the frame is returned to the channel. This requesting and returning of frame buffers 
allows data to move about with a minimum of copying. 

[0061] Each task has a specified Input and Output channel. Once a channel is created, it should be designated as 
10 the input to one task, and the output to another task. A channel's ID includes a device ID, so channels can pass data 
between processors. Channel data flow across the Host-DSP interface may appear as follows: 



ChanPktFlag 


Channel ID 


Count 


Data[...] 



The following are the channel functions: 
20 Create_ChanneJ 

BOOL Create_Channel(T_DevicelD DevID, T_Size framesize, T_Count numframes, TjChanID 'ChannellD, U16 'en- 
code); 

25 [0062] This function creates a data frame-based communication channel. This creates a channel control structure, 
which maintains control of a set of frame buffers, whose count and size are specified in the numframes and framesize 
parameters, respectively When created, the channel allocates the data frames, and adds them to its list of empty 
frames. ChannellD will return the ID of the new channel. If the DevID is not that of the calling processor, a channel con- 
trol structure is created on both the calling processor and the DevID processor, to control data flowing across the com- 

30 munications interface. The encode parameter will contain the following possible results: 

CHANSUCCESS 
C H AN_D E VI D_NOT_FOUN D 
CHAN_DEVID_NOT_RES PON DING 
35 CHAN_ALLOCATION_ERROR 

Delete_Channel 

BOOL Delete_Channel(T_ChanlD ChannellD, U16 'encode); 

40 

[0063] This function deletes an existing channel specified by ChannellD. The errcode parameter will contain the fol- 
lowing possible results: 

CHAN_SUCCESS 
as CHAN_DEVID_NOT_FOUND 

CHAN_DEVID_NOT_RESPONDING 
CHAN_CHANNEL_NOT_FOUND 

Request_Empty_Frame 

50 

BOOL Request_Empty_Frame(T_LocalChanlD Chn t T_DSP_Word "bufptr t BOOL WaitFlag, U16 'errcode); 

[0064] This function requests an empty frame from the specified local channel ID. ff Chn is NULL, then the task's out- 
put channel is used. Upon return, the bufptr parameter will contain the pointer to the frame buffer. If the WaitFlag is 
55 TRUE, and there is no frame buffer available, the caller will be suspended until a buffer becomes available. If the 
WaitFlag is FALSE, the function will return regardless. The errcode parameter will contain the following possible results: 

CHANSUCCESS 
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CHAN_CHANNEL_NOT_FOUND 
CHAN_BUFFE R_U N AVAI LABLE 

Return_Fu!LFrame 

5 

BOOL Return_FuILFrame(T_LocalChanlD Chn, T_DSP_Word 'bufptr, U16 'encode); 

[0065] Once a task has filled a frame buffer, it returns is to the channel using this function. The buffer pointed to by 
bufptr is returned to the channel ID specified. If Chn is NULL, then the task's output channel is used. The encode 
w parameter will contain the following possible results: 

CHAN_SUCCESS 

CHAN_CHANNEL_NOT_FOUND 

CHAN_BUFFER_CTRL_ERROR 

15 

Request_Full_Frame 

BOOL RequesLFulLFrame(T_LocalChantD Chn, T^DSP^Word "bufptr, BOOL WaitFlag, U16 'encode); 

20 [0066] This function requests a full frame of data from the specified local channel ID. If Chn is NULL, then the task's 
input channel is used. Upon return, the bufptr parameter will contain the pointer to the frame buffer. If the WaitFlag is 
TRUE, and there are no full frame buffers available, the caller will be suspended until a buffer becomes available. If the 
WaitFlag is FALSE, the function will return regardless. The encode parameter will contain the following possible results: 

25 CHAN_SUCCESS 

CHAN_CHANNEL_NOT_FOUND 
CHANBUFFERJJNAVAILABLE 

Return_Empty_Frame 

30 

BOOL Return_Empty_Frame(T_LocalChanlD Chn, TJDSPJWord 'bufptr, U16 'encode); 

[0067] Once a task has used the data from a frame buffer, it should return the buffer to the channel using this function. 
The buffer pointed to by bufptr is returned to the channel ID specified. If Chn is NULL, then the task's input channel is 
35 used. The encode parameter will contain the following possible results: 

CHAN_SUCCESS 

CHAN_CHANNEL_NOT_FOUND 

CHAN_BUFFER_CTRL_ERROR 

40 

Set_Task_lnput_Channel 

BOOL SeUaskJnpuLChannet(T_Ta$k 'TaskID, T^ChanlD ChanID, U16 'encode); 

45 [0068] This function sets a task's input channel to the specified channel ID. The encode parameter will contain the 
following possible results: 

CHAN_SUCCESS 
CHAN_DEVID_NOT_FOUND 
50 CHAN_DEVID_NOT_RESPONDING 
CHAN_TASK_NOT_FOUND 
CHAN_CHANNEL_NOT_FOUND 

Set_Task_Output_Channel 

55 

BOOL SeLTask_OutpuLChannel(T_Task 'TaskID, T^ChanlD ChanID, U16 'ernx>de); 

[0069] This function sets a task's output channel to the specified channel ID. The encode parameter will contain the 
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following possible results: 

CHANSUCCESS 
CHAN DEVID_NOT_FOUND 
5 CHAN_DEVID_NOT_RESPONDING 
CHANJTASK_NOT_FOUND 
CHAN_CHANNEL_NOT_FOUND 

Streams 

TO 

[0070] Streams are used for data, which can not be broken into frames, but which continuously flow into and out of a 
task. A stream will consist of a circular buffer (FIFO) with associated head and tail pointers to track the data as it flows 
in and out Each task can have a designated input and output stream. Stream data flow across the Host-DSP interface 
may appear as follows: 

15 



StrmPktFlag 


Stream ID 


Count 


Data[...] 



20 

Following are the stream functions: 
Create.Stream 

25 BOOL Create_Stream(T_DevicelD DevlD, T_Size FIFOsize, T_StrmlD 'StreamID, U16 'encode); 

[0071] This function creates a FIFO-based communication stream. This creates a stream control structure, which 
maintains control of a FIFO of size FIFOsize. When created, the stream allocates an empty FIFO, and initializes head 
and tail pointers to handle data flow into and out of the stream. StreamID will return the ID of the new stream. If the 
30 DevlD is. not that of the calling processor, a stream control structure is created on both the calling processor and the 
DevlD processor, to control data flowing across the communications interface. The encode parameter will contain the 
following possible results: 

STRMSUCCESS 
35 STRM_DEVID_NOT_FOUND 

STRM_DEVID_NOT_RESPONDING 
STRM_ALLOCATION_E RROR 

Delete.Channel 

40 

BOOL Deiete_Stream(T_StrmlD StreamID, U16 'encode); 

[0072] This function deletes an existing stream specified by StreamID The encode parameter will contain the follow- 
ing possible results: 

45 

STRM_SUCCESS 
STRM_DEVID_NOT_FOUND 
STRM_DEVID_NOT_RESPONDING 
STRM_STREAM_NOT_FOUND 

50 

Get_Stream_Courrt 

BOOL GeLStream_Count(T_LocalStrmlD StrmlD t T_Count 'count, U16 'encode); 

55 [0073] This function requests the count of T_DSP_Words currently in the stream FIFO specified by StrmID The count 
parameter will contain the number upon return. The encode parameter will contain the following possible results:. 

STRM_SUCCESS 
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STRM_STREAM_NOT_FOUND 
Write.Stream 

5 BOOL Write_Stream(T_LocalStrmlD Strm, T_DSP_Word 'bufptr TjCount count TjCourtt 'countwritten, U16 'err- 
code); 

[0074] This function will write count number of T_DSP_Words to the stream specified by the Strm. If Strm is NULL, 
the task's output stream is used. The data is pointed to by the bufptr parameter. Upon return, countwritten will contain 
io the number of T_DSP_Words actually written. The encode parameter will contain the following possible results: 

STRM.SUCCESS 
STRM_DEVID_NOT_FOUND 
STRM_DEVID_NOT_RESPONDING 
15 STRM_STREAM_NOT_FOUND 
STRM_STREArVLOVERFLOW 

Read_Stream 

20 BOOL Read_Stream(T_LocalStrmlD Strm f T_DSP_Word 'bufptr, fjCount maxcount t BOOL WaitFlag, T_Count 
'countreadUie 'encode); 

[0075] This function reads data from the stream specified by Strm. If Strm is NULL, the task's input stream is used. 
The data will be stored in the buffer pointed to by bufptr. Up to maxcount T_DSP_Words will be read from the stream. 
25 The countread parameter will contain the actual count of the data read. The encode parameter will contain the following 
possible results: 

STRM_SUCCESS 
STRM_DEVID_NOT_FOUND 
30 STRM_DEVID_NOT_RESPONDING 
ST RM_ST RE AM_NOT_FOUND 

Set_TaskJnput_Stream 

35 BOOL SeLTaskJnput_Stream(T_Task 'TaskID, T_StrmlD StrmID, U16 'encode); 

[0076] This function sets a task's input stream to the specified stream ID. The encode parameter will contain the fol- 
lowing possible results: 

40 STRM.SUCCESS 

STRM_DEVID_NOT_FOUND 
STRM_DE VID_NOT_RESPOND ING 
STRM_TASK_NOT_FOUND 
STRM_STREAM_NOTJ=OUND 

45 

Set_Task_Output_Stream 

BOOL SelJask__OutpuLStream(T_Task 'TaskID, TJStrmlD StrmID, U16 'encode); 

so [0077] This function sets a task's output stream to the specified stream ID. The encode parameter will contain the 
following possible results: 

STRM_SUCCESS 
STRM_DEVID_NOT_FOUND 
55 STRM_DEVID_NOT_RESPONDING 
STRM_TASK_NOT_FOUND 
STRM_STREAMNOT_FOUND 
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DATA TYPES 

[0078] Data types used herein are defined in Table 3: 

Table 3 



Symbol 


Description 


S8 


Signed 8-bit integer. 


U8 


Unsigned 8-bit integer. 


S16 


Signed 16-bH integer. 


U16 


Unsigned 16-bit integer. 


S32 


Sianed 32-bit inteaer. 


U32 


Unsigned 32 -bit integer. 


T HostWbrd 


A word on the Host Drocessor. 


T DSP Word 


A word on the DSP Drocessor 


Rnni 

Ovvu 


Boolean value fTRUE or FALSER 


T HootPtr 


Pointer on the Host Drocessor 


T DSP Ptr 


Pointer on the DSP Drocessor 




Prorp^or device ID 




A structure containina fields for a device ID and a Drocessor local task ID. 


T PhanlD 


A structure containina fields for a device ID and a Drocessor local channel ID. 




Mpecone ID 


T nsp ID 


An ohiect ID on the DSP 

r^l 1 UUJCwi IL^ WI 1 11 IC L/Wl . 


T_Count 


Data type for a count 


T_Size 


Data type for a size. 


T_HostCallBack 


Value used when tasks send message back to the Host 


T_ReplyRef 


Message reply reference. 


T_LocalTa$klD 


Local task ID. 


TJ-ocalChanID 


Local channel ID. 


T_DSP_Name 


Name for DSP objects (RTOS dependent). 


T_CodeHdr 


Code header structure for a DSP Library entry. 


T_TaskCreate 


Task creation structure. 



45 

SYSTEM MESSAGES 

[0079] These tables define the messages passing between devices (i.e. Host to DSP 16). The device IDs present as 
parameters in the corresponding function calls are not incorporated in the messages since they are used to actually 
so route the message to the device. Similarly, task IDs that include a device ID as their upper half for the function call will 
not include the device ID in the message, but only the DSP's local task ID portion. 



55 
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Table 4 



5 


DSP-API Messages 


Message 


Send Parameters 


Reply Parameters 


Direction Host o 

l/Or 




opt lAIDC 


iMone 


yj&d mips 




10 


OCT UCM AX/AII 




i _oize prog mem 


— > 






T_Size datamem 






ALLUC_MbM 


U16 mempage 
T_Size size 


T_Uor_wora memptr 
U16 errcode 




15 


CDCC MCM 


uid mempage 

T HQP \&lr\rrl *mamntr 
I L/Or WOl U iTlcl I ffJU 


u id errcoae 






Dl IT Dl OD 

rU I_dLUd 


i_uor_rir oestaoor 


u id errcoae 


— > 


20 




uio mempage 








i_bize size 

T_DSP_Word BLOB[size] 








PDCATC TAOl/ 

CRfcATfc_TAbK 


T_TaskCreate tcs 


i_iasKiu lasKiu 


— > 


25 






U16 errcode 






STARTJTASK 


TJaskID TaskID 


U1 6 errcode 


-» 




SUSPENDJTASK 


T_Task)D TaskID 


U16 errcode 


-> 


30 


RESUME_TASK 


T__TasklD TaskID 


U1 6 errcode 


-> 




nn PTC taoi/ 
DfcLeTfc_TAbK 


T_Taskiu Taskiu 


Uio errcoae 


— > 




CHANGE_PRIORITY 


T_ TaskID TaskID 
Uio newpriority 


U16okjpriority 
Uio errcoae 




35 


GET_TASK_STATUS 


T_TasklD TaskID 


U1 6 status 
U1 6 priority 
T_Chan!D Input 


-> 


40 






T_ChanlD Output 
U1 6 errcode 






GETJD 


T_DSP_Name Name 


TJ)SPJD ID 
U1 6 errcode 





Table 5 



DSP Interface Layer / Channel Interface Layer Messages 


Message 


Send Parameters 


Reply Parameters 


Direction Host o 
DSP 


CREATE_CHANNEL 


T_Size framesize 
T_Count numframes 


T_ChanlD ChannellD 
U16 errcode 


-* 


DELETE_CHANNEL 


T_ChanlD ChannellD 


U16 errcode 


-> 
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Table 5 (continued) 



DSP Interlace Layer / Channel Interface Layer Messages 


Message 


Send Parameters 


Reply Parameters 


Direction Host o 
DSP 


CREATE_STREAM 


T_Size FIFOsize 


T_StrmlD StreamID 
U1 6 encode 




DELETE_STREAM 


T_Strm!D StreamID 


U16 encode 


-» 





Debug Messages 




Message 


Send Parameters 


Reply Parameters 


Direction Hosto 
DSP 


20 


READJvlEM 


U16mempage 
T_DSP_Ptr addr 
T_Courrt count 


T_DSP_Word memlcount] 
U16 encode 




25 


WRITE_MEM 


U16mempage 


U16 encode 


-> 




T_DSP_Ptr addr 
T_Count count 
T_DSP_Word mem[count] 






30 


READ_REG 


U16ReglD 


DSP_WORD regvalue 
U16 encode 






WRITE_REG 


U16 RegID 


U16 encode 




35 




T_DSP_Word regvalue 






SET_BREAK 


T_DSP_Ptr addr 


U16 encode 






CLR_BREAK 


T_DSP_Ptr addr 


U16 encode 






BREAK_HIT 


T_DSP_Ptr addr 


1116 ACK 





40 



DOWNLOADING NATIVE CODE 

[0080] Figures 4 - 6 illustrate an embodiment for downloading native code to a target processor (i.e., the host 12 or 
DSP 1 6) in a secure and efficient manner. This embodiment for downloading code could be used, for example, in down- 
45 loading code from the Internet, or other global network, from a Local or Wide Area Network, or from a peripheral device, 
such as a PC Card or Smartcard. 

[0081 ] In Figure 4. an embodiment of a JAVA Bean 90 is shown, where the Bean 90 acts as a wrapper for native code 
92. The Bean further includes several attributes 94, listed as a Code Type attribute 94a, a Code Size attribute 94b and 
a MIPS Required attribute 94c. The Bean 90 has several actions 96. including a Load Code action 96a, a Load Param- 

50 eters action 96b and an Execute Parameter 96c. 

[0082] In operation, the Load Code action 96a is used to load external native code (native to the target processor) 
into the Bean. Since JAVA Beans have persistence, the Bean 90 can store its internal state, including the native code 
92 and the attributes 94. The Load Parameters action 96b retrieves parameters from the native code 92 (using, for 
example, the COFF file format described above) and stores the parameters as attributes 94a-c. The Execute action 96c 

55 executes tasks installed in the DSP 1 6. 

[0083] Figure 5 illustrates use of the Bean 90 to download code to the target processor. In this example, it is assumed 
that the target processor is the DSP 1 6 (or one of multiple DSPs 16), although it could be used to download native code 
to the host processor 12 as well. Further, it is assumed that the desired Bean 90 is resident in a network server, such 
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as a LAN server or an Internet server, although the Bean could be resident in any device in communication with the plat- 
form 10, such as a Smart card. For a wireless data platform 10, the connection to the network server 100 will often be 
wireless. 

[0084] In Figure 5, the platform 10 is coupled to a network server 100. The host processor 12. as shown in greater 
5 detail in Figure 2, may execute one or more JAVA applets 40 through a JAVA virtual machine 44. In order to download 
new code, the host 12 loads an applet containing the Bean 90 from the network server 100 or the Bean, without the 
containing applet can be downloaded from the server 100. Once the wrapper Bean 90 has been retrieved, it can be 
queried for the size of the native code, code type (for which processor is the code intended) and MIPs required. If the 
intended processor has sufficient resources to run the code 92, the code 92 can be installed to execute on the intended 
10 processor, either the host processor 12 or DSP 16 in the architecture shown in Rgure 5. Typically, the native code 92 
will be unlinked, compiled coda Thus, the cross linker 82 of the DSP-API 50 will link the code to a available memory 
location. The Bean would pass the binary native code 92 to the dynamic cross linker 82, which would install and execute 
the code. 

[0085] A typical manner in which a download of native code might occur is when the user is running an applet in which 
75 a DSP function is desired. First the applet would check to see if the desired code was installed as a task 60 in the DSP 
or was available in the DSP Library 58. If so, the task could be executed without a download. 
[0086] If the task is not stored in the DSP 16 or the DSP library 58, an object (referred to as the "DSPLoader" object 
herein) could be created to load the Bean 90. If the DSPLoader dass is local on the host 12, JAVA will check to see if 
the Bean is available locally as well. In a first instance, there may be a Bean with the code stored locally. If so, the code 
20 from the Bean is installed to the DSP (or to whichever processor specified by the Code Type). If a Bean without the code 
is stored locally, the Bean can retrieve the code from the appropriate server. 

[0087] On the other hand, if the DSPLoader object is not local, then JAVA will load the Bean 90 from the server that 
wrote the applet. The code from the Bean will then be installed as described above. 

[0088] While the downloading of native code is described in connection with the use of a JAVA Bean, it could also be 
25 accomplished by wrapping the code within another language, such as an ActiveX applet. 

[0089] Using a JAVA Bean (or other applet) as a wrapper to the native code has significant advantages. First, it allows 
a simple, standard method for loading code onto one of a plurality of processors. The Bean is created, code is loaded 
into the Bean and the code is linked to the appropriate processor. Without wrapping the code within the Bean, the proc- 
ess may take several hundred steps. Second, it allows multiple pieces of native code to be combined by a single applet, 
30 providing for complex applications to be generated from multiple discrete routines using a single applet to combine the 
routines as desired. Third, it takes advantage of the language's security features, thereby protecting not only the JAVA 
code in the Bean 90, but the native code 92 as welt. Other languages, such as ActiveX, have security features as well. 

SECURITY 

35 

[0090] Two of the most important security features are digital signing and encryption. A JAVA Bean or ActiveX applet 
may be signed by the source of the code; when the Bean or applet is downloaded, the signature is verified by the receiv- 
ing application, which has a list of trusted sources. If the Bean or applet is signed by a trusted source, it can be 
decrypted using standard techniques. Accordingly, the native code is encrypted during transmission along with the 
40 code of the Bean or applet preventing unauthorized modification of the code. Because the native code is secure and 
comes from a trusted source, the attributes can also be trusted as accurate. 

[0091] Figure 6 illustrates a flow chart describing the process of downloading native code for a processor using a 
JAVA Bean, it being understood that the native code could be wrapped in an applet of a different language using similar 
techniques. In step 110, the encrypted, digitally signed Bean 90 is downloaded to a device running a JAVA virtual 

45 machine. In step 1 12, the signature is verified, if it is not from a source listed as a trusted source, exception processing 
is enabled in step 114. In the case of the Bean coming from a trusted source, the exception processing function may 
give the user an opportunity to accept the Bean, rf the user is comfortable with the source, ff the signature is invalid, the 
exception processing may delete the Bean 90 and send an appropriate error message to the user. 
[0092] If the signature is valid and comes from a trusted source, the Bean is decrypted in step 1 16. This step decrypts 

so both the JAVA code and the native code in the Bean. In step 1 18, the attributes are retrieved from the Bean 90 and in 
step 120 the applet determines whether the appropriate processor has sufficient resources to run the code. If not, the 
exception processing step 114 may decline to install the native code, or steps may be taken to free resources. If there 
are sufficient resources, the code is linked using the cross-linker and installed on the desired processor in step 122. In 
step 124, the native code is executed. 

55 [0093] Sample JAVA script for a Bean 90 is provided hereinbelow: 
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package ti.dsp.Ioader; 

import java.awt*; 
import java.io.*; 
importjava.net*; 

public class NativcBcan extends Canvas implements Serializable 
{ 

public NativcBeanO { 

setBackground(Color. white); 

funcData = new ByteArrayOutputStreamO; 

try { 

fiincCodeBase = new URL("http://localhost"); 

} 

catch (MalformedURLException e) { 
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) 

public Dimension getMinimumSizeO { 
return new Dimension(50, 50); 

) 

public void loadCodeO { 
URL baseURL = null; 
try { 

baseURL = new URL(funcCodeBase.toStringO + *f + myFunction); 

} 

catch (MalfonnedURLExccption e) { 
} 

DatalnputStrcam source = null; 
int read; 
bytcQ buffer, 

buffer ■ new byte[1024]; 
try { 

source = new DataInputStream(baseURL.openStream()); 

} 

catch (IOException e) { 

System.out.println( ,, IOException creating streams: " + e); 

} 

codeSize ■ 0; 
funcDataj-esetO; 
try { 

while (true) { 

read = source.read(buffer); 

if (read = -1) 
break; 

funcData.writc(buffer, 0, read); 

} 

) 

catch (IOException e) { 

Systcm.out.println("IOException: " + c); 

} 
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codeSize = funcData.sizcO; 
System.outprintln("Code size = " + codcSize); 

try { 

sourcc.cIoscO; 

} 

catch flOException c) { 

Systra.outprintln("IOException closing: " + c); 

} 

} 

public synchronized String getFunctionNameO { 
return myFunction; 

} 

public void setFunctionName(String function) { 
myFunction = function; 

} 

public synchronized String getCodeBaseO { 
return funcCodeBase.toStringO; 



public void sctCodeBase(String newBase) { 
try { 

fimcCodeBase = new URL(newBase); 

} 

catch (MalformedURLException c) { 

} 

public void installCodeO { 

FileOutputStream destination = null; 
File libFile = new File(myFunction); 

try { 

destination = new FileOutputStreamOibFile); 

catch (lOException e) { 

Systcm.out.printb("IOException creating streams: n 



if (destination != null) { 
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try { 

fiincData.writeTo(dcst>nation); 

} 

catch (IOExcrption c) { 

System.outprintln("IO Exception installing native code: " + e); 

} 

} 

} 

linkCode(fiincData) 

public void loadParametersO { 
} 

public void cxccutcO { 
} 

public synchronized int getCodeSizeQ { 
return codcSize; 

} 

public synchronized int getCodeTypeO { 
return codeTypc; 

} 

public void setCodeType(int newType) { 
codeType = newType; 

} 

private int codeSize = 0; 

private int codeType * 1; 

private String myFunction = ""; 

private URL funcCodeBase = null; 

private ByteArrayOutputStream funcData « null; 



[0094] In the script set forth above, the NativeBeanO routine creates the Bean 90 which will hold the native code. The 
loadCodeO routine gets the native code from the server. The getFunctionNameO and getCodeBaseO routines retrieve 
attributes. The instaJICodeO routine calls the cross linker to link the native code to the DSP and to load the linked code. 
The loadParametersO routine instructs the Bean to examine the native code and determine its attributes. The getCode- 
size() and getCodetypeO routines transfer the attributes to the requesting applet. 

[0095] Although the Detailed Description of the invention has been directed to certain exemplary embodiments, var- 
ious modif ications of these embodiments, as well as alternative embodiments, will be suggested to those skilled in the 
art. The invention encompasses any modifications or alternative embodiments that fall within the scope of the Claims. 
[0096] The scope of the present disclosure includes any novel feature or combination of features disclosed therein 
either explicitly or implicitly or any generalisation thereof irrespective of whether or not it relates to the claimed invention 
or mitigates any or all of the problems addressed by the present invention. The applicant hereby gives notice that new 
claims may be formulated to such features during the prosecution of this application or of any such further application 
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derived therefrom. In particular, with reference to the appended claims, features from dependent claims may be com- 
bined with those of the independent claims and features from respective independent claims may be combined in any 
appropriate manner and not merely in the specific combinations enumerated in the claims. 

[0097] Further and particular embodiments of the invention win now be enumerated by way of the following numbered 
5 clauses. 

1. A method of controlling an electronic device comprising 

external to said electronic device, storing a file of native code within an software program comprising source 
to code; 

encrypting both the source code and the native code in said software program; 
downloading the software program to said electronic device; 
decrypting said software program; 
retrieving said native code from the software program; 
75 installing said native code on a target processor; and 

executing said native code on said target processor. 

2. The method of clause 1 wherein said downloading step comprises the step of downloading the software program 
from a global network. 

20 3. The method of clause 2 wherein said downloading step comprises the step of downloading the software program 
from an Internet server. 
4. An electronic device comprising: 

circuitry for coupling to an external device storing a file of native code within an software program comprising 
25 source code, said external device encrypting both the source code and the native code in said software pro- 

gram; 

a host processor for: 

downloading the software program to said electronic device; 
30 decrypting said software program; 

retrieving said native code from the software program; 
installing said native code on a target processor; and 
initiating the execution of said native code. 

35 5. The electronic device of clause 4 wherein said software program comprises a JAVA Bean. 

6. The electronic device of clause 4 or 5 wherein said external device comprises a global network server. 

7. The electronic device of any of clauses 4 to 6 wherein said external device comprises an Internet server. 

8. The electronic device of any of clauses 4 to 7 wherein said target processor is a digital signal processor. 

9. An electronic device comprising: 

40 

circuitry for coupling to an external device storing a file of native code within an software program comprising 
source code, said external device applying a digital signature to said software program; 
a host processor for: 

45 downloading the software program to said electronic device; 

verifying said digital signature; 

retrieving said native code from the software program responsive to said verifying step; 

installing said native code on a target processor; and 
so initiating the execution of said native code. 

10. The electronic device of clause 9 wherein said target processor is a digital signal processor. 
Claims 

55 

1 . A method of controlling an electronic device comprising: 

external to said electronic device, storing a file of native code within an software program comprising source 
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code; 

encrypting both the source code and the native code in said software program, 
downloading the software program to said electronic device; 
decrypting said software program; 
retrieving said native code from the software program; 
installing said native code on a target processor; and 
executing said native code on said target processor. 

2. The method of claim 1 wherein said software program comprises a JAVA Bean. 

3. The method of claim 1 or claim 2 and further comprising the step of appending a digital signature to said software 
program. 

4. The method of claim 3 and farther comprising the steps of reading said digital signature from said software program 
15 and comparing said digital signature to a list of trusted sources. 

5. The method of any preceding claim wherein said software program further comprises attributes associated with 
said native code. 

20 6. The method of claim 5 and farther comprising the step of encrypting said attributes. 

7. A method of controlling an electronic device comprising: 

external to said electronic device, storing a file of native code within an software program comprising source 
25 code; 

applying a digital signature to said software program; 

downloading the software program to said electronic device; 

retrieving said native code from the software program; 

verifying said digital signature; 
30 installing said native code on a target processor responsive to said verifying step; and 

executing said native code on said target processor. 

8. The method of claim 7 wherein said verifying step comprising the steps of reading said digital signature from said 
software program and comparing sakJ digital signature to a list of trusted sources. 

35 

9. The method of claim 7 or 8 and farther comprising the step of encrypting said software program prior to said down- 
loading step. 

10. The method of claim 8 and farther comprising the step of decrypting said software program after said downloading 
40 step. 

11. The method of claim 1 or 9 wherein said downloading step comprises the step of downloading the software pro- 
gram from a global network. 

45 12. The method of claim 1 or 9 wherein said downloading step comprises the step of downloading the software pro- 
gram from an Internet server. 

13. An electronic device comprising: 

so circuitry fa coupling to an external device storing a file of native code within an software program comprising 

source code, said external device encrypting both the source code and the native code in said software pro- 
gram; 

a host processor for: 

55 downloading the software program to said electronic device; 

decrypting said software program; 
retrieving said native code from the software program; 
installing said native code on a target processor; and 
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initiating the execution of said native coda 

14. The electronic device of daim 13 wherein said host processor farther verifies a digital signature associated with 
said software program 

5 

1 5. An electronic device comprising: 

circuitry for coupling to an external device storing a fOe of native code within an software program comprising 
source code, said external device applying a digital signature to said software program; 
io a host processor for: 

downloading the software program to said electronic device; 
verifying said digital signature; 

retrieving said native code from the software program responsive to said verifying step; 
75 installing said native code on a target processor; and 

initiating the execution of said native code. 

16. The electronic device of any of claims 13 to 15 wherein said software program comprises a JAVA Bean. 

20 17. The electronic device of any of claims 13 to 16 wherein said external device comprises a global network server. 

18. The electronic device of any of claims 13 to 16 wherein said external device comprises an Internet server. 

1 9. The electronic device of any of claims 1 5 to 1 8 wherein said software program is encrypted and said host processor 
25 further decrypts said software program. 
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